VhlCfg / File / LegicSegmentListLegacy Value
This configuration value has been deprecated. Do not use it in new code as we may remove it in the future.
Please use LegicApplicationSegmentList instead of this value for new applications.
General information about Legic VHL definition:
A Legic VHL description consists of one or more so-called
fragments. Each fragment represents a certain data area on
a Legic card. It can be a whole segment or only a part of
it.
A fragment is described by a segment information
(this value), by its length
LegicLengthList and by the starting address within the
desired segment
LegicAddressList. Optionally a CRC checksum may be
verified for every fragment (
LegicCRCAddressList ) and a certain segment type may be
specified (
LegicSegmentType ).
The configuration value LegicSegmentListLegacy is a list of one or more segment descriptions. Every entry corresponds to a certain fragment and specifies which Legic segment has to be accessed by VHL.
This value is mandatory for a Legic VHL fragment definition.
Every entry in the list consists of at least two bytes: The
first byte specifies the method the segment is identified
and the Address mode (SegmentIdAndAdr). Depending on this
value one or more bytes follow with required identification
attributes.
Basically there are two ways to
identify a segment:
- ID: SegmentIdentification has to be set to 0. SegmentInformation is the segment ID and has to be a value between 1 and 127 (0x01...0x7F)
- Stamp: SegmentIdentification has to be set to the Stamp length. The maximum allowed value is 12 (0x0C). SegmentInformation is the desired Stamp.
"ProtocolHeaderAddressMode 1": address segment 1 in Protocol Header mode
"AdvantAddressMode 3": address segment 3 in Advant Address Mode
"ProtocolHeaderAddressMode|3 0x12 0x23 0x45": address segment with stamp "12 34 56" in Protocol Header mode
"AdvantAddressMode|3 0x12 0x23 0x45": address segment with stamp "12 34 56" in Advant Address mode
Properties
- Value ID: 0x0300/0x20
- Default value: ProtocolHeaderAddressMode 1
Format
| Name | Type/Size | Description | ||
|---|---|---|---|---|
| - | Array (until end of frame) | - | ||
| SegmentIdAndAdr | Bit mask (8 bits) |
This byte defines if the segment shall be accessed via its ID (=0) or via its Stamp (=Stamp length). The MSB determines the Address mode: Protocol Header or Advant. Advant Address Mode is only available on Legic advant readers! |
||
| AdvantAddressMode | Boolean (bit 0x80) | Use Advant address mode: Application data stored in S_DATA can be accessed starting with address 0. Stamp data is not accessible in this case. | ||
| SegmentIdentification | Integer (bit mask area 0x7F) | If segment shall be accessed via Stamp these bits define the length of the Stamp that follows. If segment shall be accessed via ID all bits have to be 0. | ||
| SegmentInformation | ASCII string (length 1 Byte) | Segment ID (length: 1) or Stamp (length: 1...12) depending on the value of SegmentIdentification | ||